home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / dviware / ln03 / rmcs / 00readme.txt < prev    next >
Text File  |  1991-10-01  |  12KB  |  207 lines
  1. DVItoLN03                       Version 4.1                   1st October 1991
  2. =========                       ===========                   ================
  3.  
  4. Changes in the V4.1 release are the introduction of two new qualifiers:
  5.    /[NO]VERBOSE - the default for this may be set up at a site as either state;
  6.                   with /NOVERBOSE, most terminal output is suppressed, apart 
  7.           from the name of the input file, the total bytes of down-
  8.           loaded fonts, and progress indication as each page is output.
  9.    /PAPER_SIZE  - the default for this should reflect the setting of the paper
  10.                   size selection switch on the rear of the machine.  The program
  11.           requires knowledge of the physical paper size to handle pages
  12.           which mix landscape and portrait orientation material.
  13.  
  14. This distribution contains the following files:
  15.  
  16. 00README.TXT         -   the file you are reading
  17.  
  18. Files for building the program:
  19. DVITOLN03.CH         -   a change file for DVItoLN03, for revising V4.0 of the
  20.                          Web to V4.1
  21. DVITOLN03.CLD        -   VMS command language definition for the DVILN03 command
  22. DVITOLN03.EXE        -   a ``load-and-go'' executable, for VMS V5.4-2
  23. DVITOLN03.OBJ        -   object code, for linking uder different versions of VMS
  24. DVITOLN03.WEB        -   the WEB source of DVItoLN03 (V4.0)
  25.  
  26. Files for generating the documentation:
  27. CHANGEBAR.STY        -   for those without this: style option for changes
  28. DVILN03.HLP          -   on-line (DCL) help for DVItoLN03
  29. DVILN03.LN3_PUBLISH  -   file ready to be COPYed to your LN03
  30. DVILN03.TEX_PUBLISH  -   the ``local guide'' for DVItoLN03 (in LaTeX)
  31. LOCAL_GUIDES.BIB     -   a BibTeX database used at RMCS --- needs BibTeX V0.99c
  32. GRAPHICS.STY         -   a local LaTeX style file for graphics inserts
  33. OPENCLOSE.SIX        -   a Sixel dump of the screen of a terminal, scaled 2:1
  34. OPENCLOSE.SMALL      -   the same dump, but scaled 1:1
  35. TEXPRINT.COM         -   command procedure implementing the TEXPrint command
  36. (Note that LOCAL.MF is no longer included; better collections of mode_defs have
  37. been published, and are available from good archives everywhere.)
  38.  
  39. DVILN03.HLP is a standard (DCL) help file, for inclusion in SYS$HELP:HELPLIB.HLB
  40. or your local specialized help library. 
  41.  
  42. ********************************************************************************
  43. *  This bit is IMPORTANT: many of the reports that the author receives that    *
  44. *  ``DVItoLN03 doesn't work properly'' are because the sites have not set up   *
  45. *  the LN03 device correctly.  The only place this is specified is in the user *
  46. *  manual, and if your printer isn't already set up correctly, it won't PRINT  *
  47. *  unless you send it with PRINT/PASSALL.  And even then, it won't come out    *
  48. *  correctly if the DIPswitch on the printer is set to AutoWrap!               *
  49. ********************************************************************************
  50. You should produce a copy of our local guide. If your LN03 is not spooled, then
  51. simply COPY the file DVILN03.LN3_PUBLISH directly to YOUR LN03.  Please note
  52. that this file includes LOTS of eight-bit characters, so you may need to fetch
  53. it again in binary mode if your FTP connection has stripped off the 8th bit.  If
  54. your LN03 is set up as a printer queue (as the local guide recommends), the
  55. safest bet is to PRINT it /PASSALL until you've found out how to set up the
  56. queue compatibly; one important caveat is that the terminal line MUST be set up
  57. /NOWRAP (see the local guide).
  58.  
  59. Everything is explained, I hope, in the local guide.  As supplied,
  60. DVILN03.TEX_PUBLISH assumes that you have a working copy of the previous version
  61. (V3.1-1 or later) of DVItoLN03, but it does not use any of the special
  62. facilities provided by this new release.
  63.  
  64. If you are currently using a different driver, you will have to modify the line
  65. at the start of DVILN03.TEX_PUBLISH that reads
  66. > \let\iffulldoc=\iftrue  %%% Change to \iffalse if you don't have DVItoLN03
  67. to say instead
  68. > \let\iffulldoc=\iffalse %%% Change to \iffalse if you don't have DVItoLN03
  69. and then LaTeX it and pass through your existing driver.
  70.  
  71. The guide should be edited to suit YOUR site; I have attempted to flag all
  72. site-specific details in DVILN03.TEX with the string SYSDEP, on, or near to, the
  73. relevant line(s).  Ensure that you define the macros \sitename and \contact; all
  74. queries at any site should be channelled through the latter individual, and if
  75. he/she cannot resolve them, then I shall be delighted to (attempt to) help.
  76.  
  77.  
  78. However, the real meat is in DVITOLN03.WEB; this is a WEB version of a DVI-to...
  79. driver for the DEC LN03/LN03-Plus laser printers.  This program has been revised
  80. to V4.0 and is now capable or reading EITHER packed or expanded raster files,
  81. virtual fonts, missing fonts (!), landscape/portrait orientation (mixed on one
  82. page, even!).  It also supports the DEClaser~2100 and~2200 (otherwise known as
  83. the LN05 and LN06).
  84.  
  85. Packed (.nnnPK) files are used in preference to .PXL files (if both are
  86. available), and are sought in directory given by the /PK_FONT_DIRECTORY
  87. qualifier; the .CLD file provided specifies this as TEX_PK:.  PXL files are
  88. sought in the directory given by the /PXL_FONT_DIRECTORY qualifier, and, at
  89. RMCS, are kept in separate subdirectories of TEX_PXL_ROOT:, which is a concealed
  90. device specified as the value for this qualifier.  Details are given in the user
  91. guide, including rearranging the allocation of font files to different directory
  92. structures.  The program no longer looks in TEX$FONTS: for .TFM files, but
  93. instead in whatever is defined as the default for the /TFM_DIRECTORY qualifier;
  94. this allows TeX administrators to abandon use of logical names with dollars in
  95. them, as recommended by Digital.
  96.  
  97. This implementation of DVItoLN03 has the following advantages over certain other
  98. DVItoLN03 programs (these are not in order of importance; the new features are
  99. at the end of the list):
  100.  
  101.    i) It IS written in WEB, as opposed to C and other such kludgy languages.
  102.   ii) It downloads to the LN03's font memory the rasters for only those
  103.       characters actually used in the document.  As such, it does not run out
  104.       of font memory just because you've used a few characters from each of a
  105.       large number of different fonts.
  106.  iii) It HAS a capacity for SIMPLE graphics inclusions.  These have to be in a
  107.       format the LN03 understands (DEC sixels), and are copied verbatim into
  108.       the output file generated.
  109.   iv) It works in landscape and portrait orientations.
  110.    v) It makes use of the ``proper'' VAX/VMS DCL interface for commands.
  111.   vi) It CAN print glyphs whose rasters are too large to be downloaded to the
  112.       LN03 as a font file (by performing a sixel graphics dump of the bitmap);
  113.       obviously this slows things down considerably!
  114.  vii) It CAN handle the invisible fonts used by SliTeX; each such character is
  115.       actually downloaded as a null character locator, ans is imaged by the
  116.       appropriate amount of whitespace.
  117. viii) Either packed or unpacked font files (or both) may be provided in either 
  118.       flat or rooted directory structures; if logical names are used to specify
  119.       these locations (as in the .CLD file provided), the files may be spread
  120.       over a number of different directories or volumes. 
  121.   ix) The error messages are improved over earlier versions of the program, and
  122.       are now all indexed in the woven (WEAVEd?) WEB.  They are also all listed
  123.       in the users' manual.
  124.    x) The program can now handle fonts with more then 128 characters, up to
  125.       TeX's limit of 256.  Therefore, it can now process documents which use
  126.       Silvio Levy's Greek fonts.
  127.   xi) Retention of the log (.TYP) file may now be forced, suppressed, or allowed
  128.       to be determined by the success of the processing.
  129.  xii) Minor revisions and corrections have been made, in particular, it now
  130.       correctly understands the physical limitations to the imaging area.
  131. xiii) Correct some log reports; report files read (except font files); provide
  132.       the /OUTPUT qualifier, to permit utilization of a scratch directory or
  133.       direct spooling to the output device.
  134.  xiv) Support for Flavio Rose \special commands, for drawing changebars, was
  135.       added by Robin Fairbairns at Laser Scan of Cambridge, UK.
  136.   xv) TeX Font Metrics (TFM files) are no longer sought in the hard-wired
  137.       directory TEX$FONTS:, but are instead controlled through the
  138.       /TFM_DIRECTORY qualifier.
  139.  xvi) Support for Virtual Fonts; the .VF files are sought in whatever is
  140.       specified as the value of the /VIRTUAL_DIRECTORY qualifier; users can
  141.       speed processing fractionally by specifying /NOVIRTUAL_DIRECTORY if it is
  142.       known that no virtual fonts are used in the document.  If virtual fonts
  143.       are never used at your site, make this the default.
  144. xvii) Fonts for which the program cannot find any rasters no longer cause the
  145.       processing to be abandoned; solid rules of appropriate dimensions are
  146.       subsituted for each missing glyph.
  147. xviii)Landscape and portrait mode material may be mixed within a document, and
  148.       even on a single page, through \special{landscape} and \special{portrait}.
  149.       However, some suitable style option still needs to be written to make this
  150.       feature useful.
  151.  xix) Qualifiers /LEFT_MARGIN and /TOP_MARGIN now take a dimension (eg 1in)
  152.       rather than being required to be entered in pixels; the additional
  153.       <physical unit> called PX (pixel) has been added to TeX's normal set.
  154.   xx) Support for the new DEClaser 2100 and 2200 printers has been provided by
  155.       Karsten Nyblad of the Danish Telecomms Research Lab.  Users can select the
  156.       paper source tray, separately for the first and subsequent sheets, and
  157.       also the printing mode (simplex or duplex).  There is even a duplex mode
  158.       for the ordinary LN03 (no, it doesn't really print two-sided) which, by
  159.       interspersing blank sheets at appropriate points, produces a single-sided
  160.       master suitable for photocopying directly to a double-sided document.
  161.  xxi) Last, but definitely not least, the program has been speeded up, in both
  162.       the font mapping and the imaging phases, so that overall it runs
  163.       approximately 25% faster than V3.1-4.
  164.       
  165.  
  166. The program assumes that the LN03 has sufficient font memory --- for most
  167. meaningful documents you will need at least one RAM cartidge (part number
  168. LN03X-CR); the program WILL work with just the RAM in the basic printer, but you
  169. will probably have to restrict yourself to printing documents 3--4 pages at a
  170. time: very messy!  Not having one personally, I don't know what memory
  171. requirements apply to the new DEClaser printers.
  172.  
  173. Known deficiencies: none (I hope).
  174.  
  175. Possible future work:
  176.         Make the program accept binary files (DVI, TFM and fonts) that are not
  177.     in the default organization used by TeXware under VMS (512-byte fixed-
  178.     length records).  This would make importing such files from other
  179.     operating systems, such as Unix or MS-DOS, easier, since at present such
  180.     files have to be padded out to some multiple of 512 bytes, and moreover
  181.     with some appropriate characters, which differs from file to file.
  182.     
  183.         Any other suggestions???
  184.  
  185.  
  186. Contact
  187. =======
  188. If anyone is experiencing difficulty in installing DVItoLN03, they are welcome
  189. to contact the author ---
  190.  
  191.    B Hamilton Kelly
  192.    Royal Military College of Science
  193.    Shrivenham
  194.    SWINDON
  195.    UK     SN6 8LA
  196.  
  197. Swindon (++44 793) 785252 [Direct line]
  198.  
  199. or via JANET:    tex@uk.ac.cranfield.rmcs
  200.     INTERNET:   tex%uk.ac.cranfield.rmcs@nsfnet-relay.ac.uk
  201.       Bitnet:   tex@rmcs.cranfield.ac.uk
  202.  
  203.  
  204.                         Good Luck!
  205.  
  206.                             Brian HAMILTON KELLY
  207.